home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 014 / arce30e.arc / ARCE30E.DOC < prev   
Encoding:
Text File  |  1987-04-02  |  9.7 KB  |  421 lines
  1.  
  2. ARCE Command                        Version 3.0e
  3. ------------                        Apr  2, 1987
  4.  
  5.  
  6. Purpose:
  7.     To extract files from an ARC archive file.
  8.  
  9. Format:
  10.  
  11.     ARCE  [d:][path]filename.ext  [filespecs...] [d:outpath]
  12.                       [/R]
  13.                       [/Q]
  14.                       [/P]
  15.                       [/T]
  16.                       [/Gpassword]
  17.  
  18. Remarks:
  19.  
  20.     The drive and path names are optional.    If omitted, the  current
  21.     drive and path name is used.
  22.  
  23.     The filename must be  supplied.  The extension defaults  to ARC.
  24.     All files matching the supplied filename are processed.  The ARC
  25.     filename may contain the * and ? wildcard characters.
  26.  
  27.     If  no    filespecs  are     supplied,  all  files    are   extracted.
  28.     Otherwise, only those ARC members  which match one of the  up to
  29.     16 filespecs are extracted.
  30.  
  31.     The extracted files  may be placed  on another drive,  and/or in
  32.     another subdirectory by following the optional filespecs with  a
  33.     drive designator and/or path name.
  34.  
  35.     If  the  file  being  extracted  already  exists,  you are asked
  36.     whether or not you want to over-write it.  You may use the |  /R
  37.     option to bypass this prompt.  Use a Y followed by the |  return
  38.     key to over-write the file.
  39.  
  40.     Use the /Q option to suppress alarm sounds, beeps, and bells.
  41.  
  42.     Use  the  /P  option  to  write  the  extracted files to the DOS
  43.     standard output  file.    With  /P, you  may pipe  or redirect the
  44.     output.  An initial line feed  is added to the beginning  of the
  45.     output file.
  46.  
  47. |    Use the /T option to test the archive's integrity. No files will
  48. |    be extracted.
  49.  
  50. |    If the file was encrypted, use the /G option to supply the  same
  51. |    password as was used to create the file, e.g. /GSECRET.
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62. ARCE Command                        Version 3.0e
  63. ------------                        Apr  2, 1987
  64.  
  65.  
  66.  
  67.             Examples
  68.             --------
  69.  
  70.     o  Extract all file from TEST.ARC onto the current drive:
  71.  
  72.           ARCE TEST
  73.  
  74.     o  Extract only file with  an extension of .ASM from the archive
  75.        SOURCE.ARC on drive B and in subdirectory SAVE:
  76.  
  77.           ARCE B:\SAVE\SOURCE *.ASM
  78.  
  79.     o  Extract  all  files    from  all  ARC files in the subdirectory
  80.        called TEST on drive C:
  81.  
  82.           ARCE C:\TEST\*
  83.  
  84.     o  Extract  all  files    from  PROGA.ARC  and  place the files in
  85.        subdirectory OLD on drive B:
  86.  
  87.           ARCE PROGA.ARC B:\OLD
  88.  
  89.     o  Extract all files with an extension of .COM and .EXE from the
  90.        archive PROGS.ARC in directory NEW\WORK on drive B, and place
  91.        the    them  in  subdirectory    SAVE\TEST  on  drive  A; replace
  92.        existing file:
  93.  
  94.           ARCE B:\NEW\WORK\PROGS *.COM *.EXE A:\SAVE\TEST /R
  95.  
  96.     o  Extract  the  file  READ.ME    from  the  archive GIZMO.ARC and
  97.        display it on the console instead of writing it to a file:
  98.  
  99.           ARCE GIZMO READ.ME /P
  100.  
  101.     o  Same as above, except  pass the extracted READ.ME file to the
  102.        LIST file viewer:
  103.  
  104.           ARCE GIZMO READ.ME /P | LIST /S
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122. ARCE Command                        Version 3.0e
  123. ------------                        Apr  2, 1987
  124.  
  125.             Error Messages
  126.             --------------
  127.  
  128.       'filename - premature EOF reading '
  129.  
  130.     Data  is  missing  from  the  archive  file.   The  program   is
  131.     terminated.
  132.  
  133.  
  134.       'filename - unable to set file datestamp'
  135.  
  136.     The file datestamp is set to the current date and time, and  the
  137.     next archive member is processed.
  138.  
  139.  
  140.       'filename - WARNING: file CRC does not match!'
  141.  
  142.     The extracted member  is left on  the output disk,  and the next
  143.     archive member is processed.   The file is probably  invalid but
  144.     is left on the disk for your examination.
  145.  
  146.  
  147.       'Invalid filespec(s)'
  148.  
  149.     The filespec syntax is incorrect.  The filename part may be from
  150.     1  to  eight  characters,  and    may  include the ? or * wildcard
  151.     characters.  The extension may be none to three characters,  and
  152.     may  include  wildcards.   There  is  a  maximum of 16 filespecs
  153.     allowed.  The program terminates.
  154.  
  155.  
  156.       'filename - file already exists. Overwrite it? (y/N) '
  157.  
  158.     The member being extracted already  exists.  If you are using  a
  159.     data  path  utility,  the  file  may  not  actually  be  in  the
  160.     subdirectory be used for output.   Respond with the letter Y  to
  161.     over-write the existing  file, or respond  with the letter  N to
  162.     skip this member and continue to the next.
  163.  
  164.  
  165.       'Abort: Stack overflow'
  166.  
  167.     The member  being extracted  has invalid  data.  The  program is
  168.     terminated.
  169.  
  170.  
  171.       'filename - invalid decode tree count'
  172.  
  173.     The member  being extracted  has invalid  data.  The  program is
  174.     terminated.
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182. ARCE Command                        Version 3.0e
  183. ------------                        Apr  2, 1987
  184.  
  185.             Error Messages (cont'd)
  186.             --------------
  187.  
  188.  
  189.       'filename - new archive format 7 not yet supported'
  190.  
  191.     Format 7 is a special file compression method used internally by
  192.     SEA,  the  authors  of    ARC.  Processing continues with the next
  193.     archive member.
  194.  
  195.  
  196.       'Unable to open archive > arcname'
  197.  
  198.     The  specified    ARC   archive  file  was   not    found,    or   was
  199.     inaccessible.  The program terminates.
  200.  
  201.  
  202.       'CREATE failed > filename'
  203.  
  204.     There was insufficient directory  space, or a failure  accessing
  205.     the output disk.  The program terminates.
  206.  
  207.  
  208.     'Invalid archive format!'
  209.  
  210.     The archive file data is invalid.  The program terminates.
  211.  
  212.  
  213.       'Incorrect DOS version'
  214.  
  215.     Version  2.0  or  later  of  PC  DOS  must be used.  The program
  216.     terminates
  217.  
  218.  
  219.       'Not enough memory.'
  220.  
  221.     A minimum  of 112k  bytes of  memory is  required.  The  program
  222.     terminates.
  223.  
  224.  
  225.       'I/O error reading from arcname'
  226.  
  227.     An incorrectable error occurred attempting to read data from the
  228.     archive file.  The program terminates.
  229.  
  230.  
  231.       'I/O error writing or disk full > filename'
  232.  
  233.     There was not  enough disk space  to write the    complete archive
  234.     member.   The  partially  extracted  file  is  scratched and the
  235.     program terminates.
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242. ARCE Command                        Version 3.0e
  243. ------------                        Apr  2, 1987
  244.  
  245.             Error Messages (cont'd)
  246.             --------------
  247.  
  248.  
  249.       'No matching file(s) found'
  250.  
  251.     No archive files were  found that matched the  supplied filename
  252.     specifications.  The program terminates.
  253.  
  254.  
  255.  
  256.       'WARNING: Skipping Squashed File!'
  257.  
  258.     A variant compression method has been used and the file can  not
  259.     be properly extracted.
  260.  
  261.  
  262.  
  263. |     'filename - ERROR: invalid file codes'
  264. |
  265. |    An error was detected while attempting to decode a crunched
  266. |    file. Either some data bytes are invalid, there are extra
  267. |    bytes, or there are bytes missing. The archive is invalid.
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302. ARCE Command                        Version 3.0e
  303. ------------                        Apr  2, 1987
  304.  
  305.             Version history
  306.             ---------------
  307.  
  308.     1.1 - 1/13/86    -initial release
  309.     1.2 - 1/14/86    - correct 'Not enough memory' checking
  310.     1.3 - 1/19/86    - make displays MS-DOS compatible
  311.     1.4 - 1/24/86    - add error messages for new ARC 5.0 formats
  312.     1.5 - 2/24/86    - adds adaptive LZW decompression for code 8
  313.     1.6 - 3/02/86    - adds file selection operands
  314.     1.7 - 3/04/86    - optimizes performance
  315.             - adds stack checking for munged LZ files
  316.     1.8 - 3/15/86    - modifies CRC computation for more speed
  317.     1.9 - 3/16/85    - minor changes
  318.     1.10 - 3/24/86    - adds wildcards for ARC file name
  319.     1.11 - 3/25/86    - improves UnCrunch performance
  320.     1.12 - 3/28/86    - corrects problem with 0-byte files
  321.             - adds outspec operand
  322.     1.13 - 4/01/86    - increases stack size for 'crunched' files
  323.             - correct 'Not enough memory' checking
  324.     1.14 - make displays MS-DOS compatible
  325.     1.15 - add error messages for new ARC 5.0 formats
  326.     1.16 - add stack checking for munged LZ files
  327.          - added adaptive LZW deompression for code 8
  328.     1.17 - added file selection
  329.     1.18 - cosmetic changes
  330.  
  331.     1.19, 3/15/86    - improved CRC calculation speed
  332.     1.20, 3/16/85    - changed test for file already exists
  333.     1.21, 3/24/86    - added wildcard for ARC file name
  334.     1.22, 3/25/86    - cosmetic changes
  335.     1.23, 3/28/86    - correct short and empty file problems
  336.     2.00, 04/08/86    - fine tuning of I/O buffering
  337.  
  338.     2.01-2.05, 4-20 thru 9/9/86
  339.             - improve unsq, correct disk full message
  340.     2.06, 9/17/86    - release from testing
  341.     2.07, from 9/19 - not released
  342.     2.08, 12/31/86 - added /P, /Q; fixed /R with redirection
  343.     2.09, 1/5/87   - correct closing of output if /P used; require return
  344.              (enter key) for over-write prompt
  345.                - add more validity checking of member headers
  346.     2.10, 1/6/87   - correct use out output file specification
  347.     2.11, 1/24/87  - some cosmetics, wrong banner version and date
  348.  
  349.     3.0a, 3/16/87  - added /G for password encryption
  350.                - added /T for integrity checking only
  351.                - correct loop in command line parsing
  352.                - internal optimization
  353.                - make intergity checking more robust
  354.     3.0c, 3/23/87  - improve extracting with file selection
  355.                - minor fixes and cosmetic changes
  356.     3.0d, 3/29/87  - correction to unsqueeze
  357.     3.0e, 4/02/87  - correct loop with invalid archives
  358.                - insure errorlevel non-zero if any errors
  359.                - correct loop in command line processing
  360.  
  361.  
  362. ARCE Command                        Version 3.0e
  363. ------------                        Apr  2, 1987
  364.  
  365.  
  366.  
  367.             Notices
  368.             -------
  369.  
  370.     ARCE (c) Copyright 1986,1987 by Vernon D. Buerg and  Wayne Chin.
  371.     All rights reserved.
  372.  
  373.     ARCE is for use with the IBM  PC using DOS 2.0 or later, and  is
  374.     for personal,  private use  only.  You    may copy  and distribute
  375.     this program freely,  provided that no    fee is charged    for such
  376.     copying  and  distribution,  and  it  is distributed only in its
  377.     original,  unmodified  state.    No  exceptions    will  be granted
  378.     without written permission.
  379.  
  380.         Vernon D. Buerg
  381.         456 Lakeshire Drive
  382.         Daly City, CA  94015
  383.  
  384.         CompuServe: 70007,1212
  385.         Data/RBBS:  415-994-2944
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.     For use by corporations,  institutions, and for profit,  contact
  393.     System Enhancement Associates for licensing information.
  394.  
  395.            System Enhancement Associates
  396.            21 New Street, Wayne NJ 07470
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.